home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / misc / KlingNum11.lha / KlingNum.DOC < prev    next >
Encoding:
Text File  |  1994-06-07  |  10.6 KB  |  157 lines
  1. KlingNum v1.1
  2. Written in 1994 by Sean Martin Newton; placed in the Public Domain.
  3.  
  4. KLINGNUM STARTED ON THE AMIGA.  IF THIS ARCHIVE IS USED ON A PC, THAT'S COOL.  BUT
  5. BE ADVISED THAT THIS DOCUMENT WILL REFER TO AMIGA TERMS; I'LL TRY TO CONSIDER PC USERS
  6. HERE AND THERE, BUT IT'LL BE PRIMARILY AMIGA.
  7.  
  8. What does this program do?
  9.    It converts decimal numbers that you give it into longhand Klingon.  The English
  10. equivalent would be a program that, when you give it 531, returns "five hundred and
  11. thirty-one".  The source I used for my numbering-system data only included the suffixes
  12. for numbers up into the millions range, so the highest number it can translate into
  13. Klingon is 9,999,999 - it also can't translate decimals, as those weren't covered in
  14. the Klingon Dictionary either.  In everyday use (DOES this program have an everyday
  15. use???), it's not likely that you'll find this a problem.
  16.  
  17.    Please note that the Klingon language is probably copyrighted by Paramount or
  18. somebody like that, so I don't recommend that anyone improve this program to the max,
  19. then try to get ShareWare donations out of it - from what I've seen in the docs for
  20. other Star Trek related software, they don't take kindly to that.  However, I haven't
  21. seen any problems for non-profit authors, so this program is thoroughly PD.  Do what
  22. you want with it; I'd APPRECIATE it if you left this doc file in, left my original
  23. KlingNum message as intact as possible if you change it, and documented any and all
  24. changes that you make to KlingNum - but if you don't, I'm not going after you with a
  25. shotgun or anything.  Anybody Klingon enough to want this program should have an
  26. equally Klingon sense of honor, and this is what I appeal to when I ask that you not
  27. file off my name and put your own in its place - ADDING, no prob.  Removing any
  28. reference to the original author, that's a bit annoying.
  29.  
  30. Anyway: Everybody and their brother, feel free to change the code or whatever.  If you
  31. manage to kill your system or shred your hard drive with it, I'm not going to be held
  32. liable for it.  You can read the code; it's 'C', and the original version was compiled
  33. on SAS/C 6.51 (I LOVE upgrade patches!!!) and doesn't use any I/O except for the
  34. standard input/output streams.  So if you decide to re-direct your output stream from
  35. KlingNum and accidentally overwrite your $5 billion 80-gigabyte database of ice cream
  36. shops in the Timbuktu area, or do something especially nasty to a network, I'm not
  37. taking responsibility for it.  If it's got weird file manipulations, then the source
  38. has been changed and you should go after the modifying people.  But don't take this to
  39. mean I won't be unsympathetic - if you blow up your 80-gig database, I'm sorry.  But
  40. since there's no way this program *alone* can do it, I'm not taking responsibility.
  41. Re-directing your output so it blows up the database is something that your operating
  42. system would actually be doing, and all KlingNum would be doing is sending data to the
  43. standard output stream - it doesn't know or care where the operating system is going
  44. to send it.  Bottom line: EVEN IF, BY SOME ABSOLUTELY IMPROBABLE CHANCE, YOU FIND A
  45. WAY TO KILL YOUR COMPUTER OR DELETE ITS FILES BY USING THIS PROGRAM, I'M NOT TAKING
  46. THE BLAME FOR IT!  It would take a LOT of effort to find a way to blow up a computer
  47. with this program, and if you can figure out a way to do it, more power to you, but
  48. don't think for a second that I'm responsible for it.
  49.  
  50.    Now that the obligatory legalistic rudeness is over, here's the stuff you're reading
  51. this file for.  The way to call up KlingNum is with: KlingNum <Number>, where Number
  52. is the decimal value you'd like to have converted into longhand Klingon.  Say, for
  53. instance, you wanted to find out what the Klingon number 56 is.  "KlingNum 56" would
  54. result in "vaghmaH jav" being displayed right under the command.  Sorry, but it can't
  55. translate decimals (6.5, etc.); they weren't covered in my reference material.  It also
  56. doesn't handle numbers greater than 9,999,999, because the positional suffixes only
  57. went up to 1 million.
  58.  
  59.    Note that there is formatting attached to the Klingon output; that's because some
  60. people might want to do nifty things with output-redirection and script files (batch
  61. files, for IBMers).  Check the bottom of this document for ways to do weird things
  62. like displaying your available memory in Klingon.  IBM users, good luck... I use and
  63. program IBMs, but I don't enjoy 'em.  They have such limitations built in at the
  64. hardware level that they act like bogus systems from the '60s and '70s!  The operating
  65. systems they use do nothing but compound and magnify those limitations.
  66.  
  67.    If you've got InterNet access, feel free to drop me a piece of E-Mail; my address is
  68. SMN8714CSCI@LYNX.APSU.EDU.  If you want to talk about improvements, discuss Star Trek
  69. in general, or dispute my vehement assaults on the cornerstones of IBM lunacy, feel
  70. free to drop me a line.  If you know what the InterNet address of the Klingon
  71. newsgroup is, please let me know; I've been trying to find it without any success
  72. whatsoever.  By the way, don't bother writing messages to me in Klingon; even though
  73. I've written a Klingon number translator, I can't read the language well enough (YET!)
  74. to understand complete messages in it.  I know some people can, and I heartily commend
  75. them for it, but sending an all-Klingon message to me would just be a waste of your
  76. time.  A phrase here and there is fine, though; I can look it up and get some
  77. practice reading Klingon.  By the way, if you're an Amiga user looking for Star Trek
  78. files (programs, images, sound files, etcetera), I can tell you some file locations on
  79. FTP sites; I keep a record of what I run across, so if there's an Amiga Star Trek game
  80. out there, I probably know where to find it.
  81.  
  82.    I realize I haven't done a very good job of commenting KlingNum, but it would be
  83. nice to know what has been changed without digging through old source.  If you make
  84. changes, please comment them so the next person can see what all's been done..  And
  85. hey, if you compile the source on a different platform, please send me a piece of
  86. E-Mail just so I can update my list of how many systems KlingNum has been spread to.
  87. Just let me know of any changes you had to make in order to get it working on those
  88. other platforms - I know VAX/VMS would probably need to dump the command-line
  89. processing so that it can prompt for a number, for instance.  I'm not going to
  90. pretend KlingNum couldn't use improvement; for instance, enhanced error checking would
  91. be nice.  I don't have any kind of ego problem about this program; if you make an
  92. improvement and toss half my code, that's fine.  One final note: even if you make
  93. spectacular, ground-breaking changes to this, if you add Klingon ships flying around
  94. and zapping each other with phasers and making sound effects, I wouldn't recommend
  95. that you try to make ShareWare out of it.  Paramount, which owns Star Trek (and
  96. probably the Klingon language as well, which is why I haven't said a word about how
  97. Klingon numbers are formed) seems to have this thing for prosecution, and a ShareWare
  98. authors have been pestered by them in the past.  As long as it's free, though, you're
  99. probably in the clear.  Matter of fact, with the way I've written this utility, it
  100. could really be thought of as a specialized utility for people who've already BOUGHT
  101. "The Klingon Dictionary", since you really should understand Klingon numbers before
  102. you go trying to read them.
  103.  
  104.    By the way, the book I referred to is "The Klingon Dictionary", by Marc Okrand.  It's
  105. a great book, and Mr. Okrand should be highly commended for boldly pulling the Klingon
  106. language out of the Final Frontier and into a readable book.  I just wish the section
  107. on Klingon numerals went into trillions, and had decimal notation (you know, 6.75,
  108. etc.) somewhere... although that will probably be solved with the Klingon
  109. Encyclopedia, which will cover a whole lot of stuff in great depth.
  110.  
  111. About the Author:
  112.    Whoopty do, my autobiography.  Hey, everybody adds something like this at the end of
  113. the text file, so I might as well do the same.  As you already know by reading the rest
  114. of the document, I'm an outspoken Amiga user who loves to give IBMers an earfull on why
  115. their systems are ridiculously inefficient and generally useless.  Currently, I'm in
  116. college, working on a Computer Science degree, and my goal in life is to write Amiga
  117. productivity programs.  I've had it with people complaining about the lack of business
  118. software, and since I feel that anyone who complains had better be prepared to do
  119. something about it, I'm going to try my best to quiet the complainers.  If you either
  120. need or are using productivity software on Amigas, let me know what kind of things you
  121. use, and what you really wish you had, so that I will know what kind of things I need
  122. to look into.  And hey, if you need a small CLI utility written, I might be able to
  123. oblige you on that mark.  Another of my interests is writing SAS/C equivalents to the
  124. Borland (BLEAH!) include files, so that Amigites using REAL compilers with REAL editors
  125. on REAL computers can write BOGUS programs that are source-compatible with BOGUS
  126. systems and thus can do their work at home when their professors decide that it's such
  127. a FUN idea to write something that REQUIRES Borland to compile!!!  It stinks!  It
  128. needs to be stopped!  If anybody has similar concerns, E-Mail me and maybe we can
  129. get a lot of this kind of IBM-specific nonsense eliminated.
  130.  
  131. And now, as promised: AN ACTUAL USE FOR KLINGNUM!!!  The following three lines are a
  132. script; I recommend you call this script "Kmem" (Klingon Mem) for consistency.
  133.  
  134. AVAIL TOTAL >ENV:FREEMEM
  135. Echo "Memory: `KlingNum $FREEMEM` ($FREEMEM)"
  136. DELETE >NIL: ENV:FREEMEM
  137.  
  138. Note that the "`"s are the "`"s located on the Tilde (~) key; if you use the other
  139. one that looks similar ("'"), the script won't display the Klingon number.  Note that
  140. this script won't show your free memory if you've got 10M or more of free RAM, since
  141. it can't translate numbers >=10,000,000.  Boy, it must be nice to run into THAT
  142. problem!  :)  By the way, Kmem is included in the original archive, so you might not
  143. have to type it in after all!  Just copy it to S: and type Kmem whenever (under 1.3+).
  144. If you type it in, be sure to go "PROTECT Kmem +S" on the command line, to make sure
  145. that AmigaDOS knows it's a script file and will run it without the EXECUTE command.
  146. On 1.2 or below, I think you'll have to type "EXECUTE Kmem" or set up an alias to do
  147. so.  Since I know of few people still using 1.2, this isn't a big deal.
  148.  
  149. Version History:
  150.   KlingNum v1.1 -  6 June  1994.
  151.     Fixed an enforcer hit occurring when no arguments are given, pointed out by
  152.     Michael Pins, in charge of Amiga PD on GRIND.ISCA.UIOWA.EDU.
  153.   KlingNum v1.0 - 28 April 1994.
  154.  
  155. yIntIQej'chep - Live Long & Prosper.
  156.  
  157.